home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / Converters / mcvert.lha / mcvert / mcvert.man < prev    next >
Encoding:
Text File  |  1994-12-18  |  10.1 KB  |  329 lines
  1. ***nroff: unrecognized command .UC 4.2
  2.  
  3. ***nroff: unrecognized command .ie  .in +
  4.  
  5. ***nroff: unrecognized command .el .in +3
  6.  
  7. ***nroff: unrecognized command .ie  .ti -
  8.  
  9. ***nroff: unrecognized command .el .ti -3
  10.  
  11. ***nroff: unrecognized command .ie  .in +
  12.  
  13. ***nroff: unrecognized command .el .in +3
  14.  
  15. ***nroff: unrecognized command .ie  .ti -
  16.  
  17. ***nroff: unrecognized command .el .ti -3
  18.  
  19. ***nroff: unrecognized command .ie  .in +
  20.  
  21. ***nroff: unrecognized command .el .in +3
  22.  
  23. ***nroff: unrecognized command .ie  .ti -
  24.  
  25. ***nroff: unrecognized command .el .ti -3
  26.  
  27. ***nroff: unrecognized command .ie  .in +
  28.  
  29. ***nroff: unrecognized command .el .in +3
  30.  
  31. ***nroff: unrecognized command .ie  .ti -
  32.  
  33. ***nroff: unrecognized command .el .ti -3
  34.  
  35. ***nroff: unrecognized command .ie  .in +
  36.  
  37. ***nroff: unrecognized command .el .in +3
  38.  
  39. ***nroff: unrecognized command .ie  .ti -
  40.  
  41. ***nroff: unrecognized command .el .ti -3
  42.  
  43. ***nroff: unrecognized command .ie  .in +
  44.  
  45. ***nroff: unrecognized command .el .in +3
  46.  
  47. ***nroff: unrecognized command .ie  .ti -
  48.  
  49. ***nroff: unrecognized command .el .ti -3
  50.  
  51. ***nroff: unrecognized command .ie  .in +
  52.  
  53. ***nroff: unrecognized command .el .in +3
  54.  
  55. ***nroff: unrecognized command .ie  .ti -
  56.  
  57. ***nroff: unrecognized command .el .ti -3
  58.  
  59. ***nroff: unrecognized command .ie  .in +
  60.  
  61. ***nroff: unrecognized command .el .in +3
  62.  
  63. ***nroff: unrecognized command .ie  .ti -
  64.  
  65. ***nroff: unrecognized command .el .ti -3
  66.  
  67. ***nroff: unrecognized command .ie  .in +
  68.  
  69. ***nroff: unrecognized command .el .in +3
  70.  
  71. ***nroff: unrecognized command .ie  .ti -
  72.  
  73. ***nroff: unrecognized command .el .ti -3
  74.  
  75. ***nroff: unrecognized command .ie  .in +
  76.  
  77. ***nroff: unrecognized command .el .in +3
  78.  
  79. ***nroff: unrecognized command .ie  .ti -
  80.  
  81. ***nroff: unrecognized command .el .ti -3
  82.  
  83. ***nroff: unrecognized command .ie  .in +
  84.  
  85. ***nroff: unrecognized command .el .in +3
  86.  
  87. ***nroff: unrecognized command .ie  .ti -
  88.  
  89. ***nroff: unrecognized command .el .ti -3
  90.  
  91. ***nroff: unrecognized command .ie  .in +
  92.  
  93. ***nroff: unrecognized command .el .in +3
  94.  
  95. ***nroff: unrecognized command .ie  .ti -
  96.  
  97. ***nroff: unrecognized command .el .ti -3
  98.  
  99. ***nroff: unrecognized command .ie  .in +
  100.  
  101. ***nroff: unrecognized command .el .in +3
  102.  
  103. ***nroff: unrecognized command .ie  .ti -
  104.  
  105. ***nroff: unrecognized command .el .ti -3
  106.  
  107. ***nroff: unrecognized command .ie  .in +
  108.  
  109. ***nroff: unrecognized command .el .in +3
  110.  
  111. ***nroff: unrecognized command .ie  .ti -
  112.  
  113. ***nroff: unrecognized command .el .ti -3
  114.  
  115. ***nroff: unrecognized command .ie  .in +
  116.  
  117. ***nroff: unrecognized command .el .in +3
  118.  
  119. ***nroff: unrecognized command .ie  .ti -
  120.  
  121. ***nroff: unrecognized command .el .ti -3
  122.  
  123. ***nroff: unrecognized command .ie  .in +
  124.  
  125. ***nroff: unrecognized command .el .in +3
  126.  
  127. ***nroff: unrecognized command .ie  .ti -
  128.  
  129. ***nroff: unrecognized command .el .ti -3
  130.  
  131. MCVERT (LOCAL)             May 5, 1987             MCVERT (LOCAL)
  132.  
  133.  
  134.  
  135.  
  136. NAME    
  137. NAME  
  138.      mcvert  -  BinHex  4.0  to  MacBinary  file  conversion
  139.      utility 
  140.  
  141.  
  142. SYNOPSIS    
  143. SYNOPSIS  
  144.      pmcvert q    [-options]    name...        [[-options]
  145.      name...]...  
  146.  
  147.  
  148. DESCRIPTION    
  149. DESCRIPTION  
  150.      The pmcvert q program translates MacIntosh files from 
  151.      one format  to  another.   The primary formats in which
  152.      MacIntosh files are represented on non-Macs are: 
  153.  
  154.  
  155.      pMacBinary: q An eight bit wide representation of the 
  156.      data and resource forks of a Mac file and  of  relevant
  157.      Finder  information,  MacBinary files are recognized as
  158.      "special"  by  several  MacIntosh  terminal  emulators.
  159.      These  emulators,  using  Kermit or Xmodem or any other
  160.      file transfer protocol, can separate the incoming  file
  161.      into  forks  and  appropriately  modify  the Desktop to
  162.      display icons, types, creation dates, and the like.  
  163.  
  164.  
  165.      pBinHex 4.0: q A seven bit wide representation  of  a
  166.      Mac  file with CRC error checking, BinHex 4.0 files are
  167.      designed for  communication  of  Mac  files  over  long
  168.      distance, possibly noisy, seven bit wide paths.  
  169.  
  170.  
  171.      pPackIt:  q PackIt files are actually representations
  172.      of  collections  of   Mac   files,   possibly   Huffman
  173.      compressed.   Packing many small related files together
  174.      before a MacBinary transfer or a translation to  BinHex
  175.      4.0 is common practice.  
  176.  
  177.  
  178.      pText:  q  A MacIntosh ends each line of a plain text
  179.      file with a carriage return character (^M), rather than 
  180.      the newline character (^J) that some  systems  seem  to
  181.      prefer.   Moreover,  a  MacBinary  file  has  prepended
  182.      Finder information that non-MacIntoshes don't need.  
  183.  
  184.  
  185.      pData, Rsrc: q A Data or Rsrc file is the exact  copy
  186.      of the data or resource fork of a MacIntosh file.  
  187.  
  188.  
  189.      It  is  the  purpose  of this program to convert to the
  190.      MacBinary format files in other of the  above  formats,
  191.      and vice versa.  
  192.  
  193.  
  194.  
  195. PARAMETERS    
  196. PARAMETERS  
  197.      Exactly   one   of  the  following  operations  may  be
  198.      specified for an input name: 
  199.  
  200.  
  201.      px q BinHex 4.0 - files in the MacBinary  format  are
  202.      translated to  BinHex  files,  or vice versa.  The name
  203.      argument may be the name of a file to be converted or a 
  204.      basename  to  which  an  appropriate  suffix  must   be
  205.      appended to  get a filename.  If the conversion is from
  206.      Binhex 4.0 to MacBinary, several files may comprise the 
  207.      BinHex representation of the Mac  file.    Rather  than
  208.  
  209.  
  210.  
  211.                                                                 1
  212.  
  213.  
  214. MCVERT (LOCAL)             May 5, 1987             MCVERT (LOCAL)
  215.  
  216.  
  217.  
  218.      manually concatenate the files and manually delete mail 
  219.      headers  and  other extraneous garbage, one may specify
  220.      the names of the files in order and pmcvert q will do 
  221.      the concatenating  and  deleting.      Conversely,   in
  222.      converting  a  MacBinary  file to BinHex 4.0 format for
  223.      mailing over long distances, one may be  restricted  to
  224.      mail messages of no greater that some fixed length.  In 
  225.      this  case,  pmcvert  q  can automatically divide the
  226.      BinHex  file  into  pieces   and   label   each   piece
  227.      appropriately.  Option 'x' is selected by default.  
  228.  
  229.  
  230.      pr  q  Resource  - files in the MacBinary format with
  231.      empty data forks and nonempty resource forks  are  made
  232.      from ordinary data files, or vice versa.  
  233.  
  234.  
  235.      pd  q  Data  -  files  in  the  MacBinary format with
  236.      nonempty data forks and empty resource forks  are  made
  237.      from ordinary data files, or vice versa.  
  238.  
  239.  
  240.      pu  q  Text  -  files  in  the  MacBinary format with
  241.      nonempty data forks and empty resource forks  are  made
  242.      from ordinary  data files, or vice versa.  Unix newline
  243.      characters are  interchanged  with  MacIntosh  carriage
  244.      return  characters,  and a newly created MacBinary file
  245.      has creator field given by the  MAC_EDITOR  environment
  246.      variable.  
  247.  
  248.  
  249.  
  250. OPTIONS    
  251. OPTIONS  
  252.  
  253.  
  254.      pp  |  q  q  If  a  BinHex to MacBinary conversion is
  255.      taking place and option 'p' is selected,  any  file  of
  256.      type  "PIT  "  will  be  unpacked  into its constituent
  257.      parts.  This option does not recursively unpack "PIT  "
  258.      files packed in "PIT " files.  If a MacBinary to BinHex 
  259.      conversion  is  taking  place, this option is currently
  260.      ignored.  By default, option 'q' is selected.  
  261.  
  262.  
  263.      pU | D q When option 'U' is selected, the  conversion
  264.      that  takes  place  is  the  one suitable for Uploading
  265.      files.  That is, the conversion is  from  MacBinary  to
  266.      something else  when  'U'  is  selected.    Conversely,
  267.      option 'D', as in Download, converts from something  to
  268.      MacBinary. Option 'D' is the default.  
  269.  
  270.  
  271.      ps  |  v  q  Normally,  pmcvert  q prints to stderr
  272.      information about the files it is creating.   Selecting
  273.      option  's',  as  in  silent,  disables this reporting.
  274.      Option 'v', for verbose, is the default.  
  275.  
  276.  
  277. ENVIRONMENT VARIABLES    
  278. ENVIRONMENT VARIABLES  
  279.      There are four environment variables  one  may  use  to
  280.      customize  the behavior of pmcvert q slightly.  
  281.  
  282.  
  283.      pMAC_EDITOR  q  The  creator  of MacBinary text files
  284.      produced with options -uD.  The default  is  MACA,  the
  285.      creator type of MacWrite.  
  286.  
  287.  
  288.      pMAC_DLOAD_DIR  q  The  MacBinary  files created when
  289.  
  290.  
  291.  
  292.                                                                 2
  293.  
  294.  
  295. MCVERT (LOCAL)             May 5, 1987             MCVERT (LOCAL)
  296.  
  297.  
  298.  
  299.      option -D is selected are  placed  in  this  directory.
  300.      The default is ".", the current working directory.  
  301.  
  302.  
  303.      pMAC_EXT q The MacBinary files created when option -D 
  304.      is  selected  are named according to the filename field
  305.      stored in the file header, with the  name  extended  by
  306.      this suffix.  The default is ".bin".  
  307.  
  308.  
  309.      pMAC_LINE_LIMIT  q  The  BinHex  files  created  when
  310.      option -U is selected may be no longer than  this  many
  311.      lines long.    Files  that  would otherwise exceed this
  312.      line limit  are  broken  up  into  several  files  with
  313.      numbers  embedded  into their file  names to show their
  314.      order.  Each such file has "Start of part x"  and  "End
  315.      of part x" messages included where appropriate.  
  316.  
  317.  
  318. BUGS    
  319. BUGS  
  320.      It  should  be  possible  to  discard bad input now and
  321.      successfully translate good input later, but bad  input
  322.      mostly just causes immediate termination.  
  323.  
  324.  
  325.      A  more  diligent  person  would support BinHex 3.0 and
  326.      BinHex 2.0 and BinHex 5000.0 B. C., but I've never seen 
  327.      anyone use them in three years.  A more diligent person 
  328.      would also do something for users of macget and macput, 
  329.      but hopefully someone will make those programs  support
  330.      the MacBinary file protocol.  
  331.  
  332.  
  333. SEE ALSO    
  334. SEE ALSO  
  335.      xbin(1), macget(1), macput(1), xmodem(1), kermit(1) 
  336.  
  337.  
  338. AUTHOR    
  339. AUTHOR  
  340.      Doug  Moore, Cornell University Computer Science. Based
  341.      upon pxbin q by Dave Johnson,  Brown  University,  as
  342.      modified  by  Guido  van Rossum, and upon punpit q by
  343.      Allan G. Weber, as well  as  upon  correspondence  with
  344.      several helpful readers of USENET.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.                                                                 3
  371.  
  372.  
  373.